home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
u_man
/
cat1
/
background.z
/
background
Wrap
Text File
|
1998-10-20
|
9KB
|
199 lines
BBBBAAAACCCCKKKKGGGGRRRROOOOUUUUNNNNDDDD((((1111)))) BBBBAAAACCCCKKKKGGGGRRRROOOOUUUUNNNNDDDD((((1111))))
NNNNAAAAMMMMEEEE
background - customization panel for setting background pattern
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
////uuuussssrrrr////ssssbbbbiiiinnnn////bbbbaaaacccckkkkggggrrrroooouuuunnnndddd
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
The _b_a_c_k_g_r_o_u_n_d customization panel is used to edit the background for a
particular desk. The user is presented with a list of different
backgrounds. All backgrounds except those using the graphics library
(GL) can be previewed. The user can select a background, modify its
colors if it is a non-GL pattern, then apply the background pattern to
the current desk.
The _b_a_c_k_g_r_o_u_n_d panel can be run from a Unix shell command line or from
the toolchest (Desktop > Customize > Background). Like most other
customization panels, the background panel has the ``runonce'' feature,
meaning only one instance of the application will at one time.
Attempting to launch the application a second time will have the effect
of deiconifying the application window or popping it to the top on the
current desk.
For more information about the entire IRIX Interactive Desktop
environment and about the XXXXUUUUSSSSEEEERRRRFFFFIIIILLLLEEEESSSSEEEEAAAARRRRCCCCHHHHPPPPAAAATTTTHHHH environment variable, see
the IID(1) man page.
FFFFIIIILLLLEEEESSSS
The backgrounds presented in this panel can be stored in one of two
files:
/usr/lib/X11/system.backgrounds (system default)
$HOME/.backgrounds (user)
Either the user's backgrounds or the system default backgrounds will be
presented in the background panel. If a $_H_O_M_E/._b_a_c_k_g_r_o_u_n_d_s file exists,
then the backgrounds on that list will be presented in the panel.
Otherwise the backgrounds in the system default file will be presented.
If the user desires to append some backgrounds to the system default
list, the user must first copy the system default file to the
$_H_O_M_E/._b_a_c_k_g_r_o_u_n_d_s file in their home directory, then use a text editor
to append new background entries to that file.
Each background entry has the following format:
bbbbaaaacccckkkkggggrrrroooouuuunnnndddd <<<<nnnnaaaammmmeeee>>>>
PPPPaaaaggggeeee 1111
BBBBAAAACCCCKKKKGGGGRRRROOOOUUUUNNNNDDDD((((1111)))) BBBBAAAACCCCKKKKGGGGRRRROOOOUUUUNNNNDDDD((((1111))))
ccccoooommmmmmmmaaaannnndddd <<<<4444DDDDwwwwmmmm ccccoooommmmmmmmaaaannnndddd>>>>
ddddeeeeffffaaaauuuulllltttt <<<<ddddeeeeffffaaaauuuulllltttt ccccoooommmmmmmmaaaannnndddd>>>>
rrrreeeeaaaaddddooookkkk <<<<ffffiiiilllleeee1111>>>>,,,, <<<<ffffiiiilllleeee2222>>>>,,,, ............
The bbbbaaaacccckkkkggggrrrroooouuuunnnndddd line defines the name of the background that the user will
see from the customization panel.
The ccccoooommmmmmmmaaaannnndddd line specifies the command that will be passed to _4_D_w_m, which
handles the management of backgrounds. This command can have formatting
characters (%1 %2 %3 ...) representing how many colors the background
requires as well as how many the user may edit, up to a maximum of five
colors.
Currently all command formats acceptable to the _x_s_e_t_r_o_o_t(_1) command may
be used, as well as a ----xxxxppppmmmm option for files in X pixmap (xpm) format.
Additionally a ----eeeexxxxeeeeccccuuuutttteeee option allows execution of any background setting
command (for example, _t_w_i_l_i_g_h_t(_6_D)). However, use of arbitrary
backgrounds set via the ----eeeexxxxeeeeccccuuuutttteeee command may degrade performance,
especially if file manager icons are on the background. Also note that
to integrate with the IRIX Interactive Desktop environment, any X program
introduced as a new background (for example, _x_e_a_r_t_h) needs to set the
_SGI_ROOTPAINTER_ID property on its window and on the root window. (This
property needs to be of type WINDOW and have a value of the window on
which the property is set.) If the background-setting program does not
set this property, then the window manager, _4_D_w_m(_1_X), will not know on
which window to perform an XKillClient operation when the user switches
desks or selects a new background. Without the property set, the
background-setting program can run multiple times, which can load the
system unnecessarily. In short, users can have any X program running as
their background, but if that program does not set the
_SGI_ROOTPAINTER_ID property, then they need to kill that program
manually every time they switch desks or switch backgrounds.
The ddddeeeeffffaaaauuuulllltttt line designates the image the user will originally see in the
viewer as well as its default colors.
The rrrreeeeaaaaddddooookkkk command checks that the files listed can actually be read. If
they can not, the background will not be presented to the user in the
_b_a_c_k_g_r_o_u_n_d panel.
For example, the following is the entry for the two-color Scatter
background pattern:
bbbbaaaacccckkkkggggrrrroooouuuunnnndddd """"SSSSccccaaaatttttttteeeerrrr""""
ccccoooommmmmmmmaaaannnndddd """"----bbbbiiiittttmmmmaaaapppp ////uuuussssrrrr////iiiinnnncccclllluuuuddddeeee////XXXX11111111////bbbbiiiittttmmmmaaaappppssss////ggggrrrraaaannnniiiitttteeee ----bbbbgggg %%%%1111 ----ffffgggg %%%%2222""""
ddddeeeeffffaaaauuuulllltttt """"----bbbbiiiittttmmmmaaaapppp ////uuuussssrrrr////iiiinnnncccclllluuuuddddeeee////XXXX11111111////bbbbiiiittttmmmmaaaappppssss////ggggrrrraaaannnniiiitttteeee ----bbbbgggg lllliiiigggghhhhttttsssstttteeeeeeeellllbbbblllluuuueeee3333 ----ffffgggg hhhhoooonnnneeeeyyyyddddeeeewwww1111""""
rrrreeeeaaaaddddooookkkk """"////uuuussssrrrr////iiiinnnncccclllluuuuddddeeee////XXXX11111111////bbbbiiiittttmmmmaaaappppssss////ggggrrrraaaannnniiiitttteeee""""
PPPPaaaaggggeeee 2222
BBBBAAAACCCCKKKKGGGGRRRROOOOUUUUNNNNDDDD((((1111)))) BBBBAAAACCCCKKKKGGGGRRRROOOOUUUUNNNNDDDD((((1111))))
NNNNOOOOTTTTEEEESSSS
4Dwm caches backgrounds for all desks. If a user has many desks, each
using many colors, the colors can fill up the colormap. Similarly, if
many desks each have large background pixmaps, much server memory can be
used.
Setting a background via the ----eeeexxxxeeeeccccuuuutttteeee flag in the background panel
differs from setting the same background from the command line in that
those backgrounds set via the background panel will be remembered across
desk switches and restarted automatically when returning to the desk.
Backgrounds started from the command line will be forgotten after a desk
switch. (However, backgrounds set using the _x_s_e_t_r_o_o_t(_1) command will be
remembered across desk switches.)
SSSSEEEEEEEE AAAALLLLSSSSOOOO
4Dwm(1X), xsetroot(1), ov(1), IID(1)
BBBBUUUUGGGGSSSS
The maximum number of editable colors in the customization panel is five.
If a pixmap contains more than that many, only the first five will be
available in the palette beneath the image viewing area.
PPPPaaaaggggeeee 3333